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COPYRIGHT NOTICE 
[0001] A portion of the disclosure of this patent document contains material 
which is subject to copyright protection. The copyright owner has no objection to 
the facsimile reproduction by anyone of the patent document or the patent 
disclosure, as it appears in the Patent and Trademark Office patent file or records, 
but otherwise reserves all copyright rights whatsoever. 

CLAIM OF PRIORITY 
[0002] This application claims priority from the following application, which 
is hereby incorporated by reference in its entirety: 

[0003] SYSTEM AND METHOD FOR STRUCTURING DISTRIBUTED 
APPLICATIONS, U.S. Application No. 60/450,226, Inventors: Daryl Olander, et 
aL, filed on February 25, 2003. (Attorney's Docket No. BEAS-1402US0) 

FIELD OF THE DISCLOSURE 
[0004] The present disclosure relates generally to software tools for portal 
development. 

BACKGROUND 

[0005] Typical frameworks for structuring distributed client/server 
applications may not be appropriate for the heavily multi-threaded environment of 



Attorney Docket No.: BEAS-01402US1 SRM/DJB 
djb/beas/1402USl application.doc 



Express Mail Label No.: EV3276221 88US 



2 

a web/application server where different users may be executing the same 
application on the same server. In addition, such frameworks may not cleanly 
separate business logic from rendering and control flow, thus making it difficult to 
compliment the framework with a visual Integrated Development Environment. 

BRIEF DESCRIPTION OF THE DRAWINGS 
[0006] Figure 1 is an illustration of an exemplary Integrated Development 
Environment graphical view of an exemplary page flow in an embodiment. 
[0007] Figure 2 is exemplary code generated automatically by an Integrated 
Development Environment in an embodiment. 

[0008] Figure 3 is an illustration of exemplary page groups in an 
embodiment. 

[0009] Figure 4 is another illustration of exemplary page groups in an 
embodiment. 

<» 

[0010] Figure 5 is an illustration of an exemplary Integrated Development 
Environment in an embodiment. 

[001 1] Figure 6 is an illustration of an exemplary system in an embodiment. 
[0012] Figure 7 is an illustration of an exemplary page group directory 
hierarchy in an embodiment. 

[0013] Figure 8 is an exemplary form rendered in an embodiment. 
[0014] Figure 9 is an exemplary JavaServer Page for rendering and binding 
the form of Figure 8 in an embodiment. 

[0015] Figure 10 is an illustration of an exemplary page group directory 
hierarchy in an embodiment. 

[0016] Figure 11 is an exemplary help page rendered in an embodiment. 

DETAILED DESCRIPTION 
[0017] The invention is illustrated by way of example and not by way of 
limitation in the figures of the accompanying drawings in which like references 
indicate similar elements. It should be noted that references to "an" or "one" 
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embodiment in this disclosure are not necessarily to the same embodiment, and 
such references mean at least one. 

[001 8] In one embodiment, page flows allow a software developer to separate 
user interface code from navigational control and other business logic. User 
interface code can be placed where it belongs (e.g., in JSP files). Navigational 
control can be implemented easily in a page flow's single controller file, which is 
the nerve center of (a component of) your web application. A page controller file is 
a special Java file that uses a JPF file extension. Business logic can be 
implemented in the page controller file, or in Java controls that you call from JPF 
files. 

[0019] The separation of presentation and business logic offers a big 
advantage to development teams. For example, site flow updates can be made in a 
single JPF file, instead of having to search through many JSP files and make 
multiple updates. In an Integrated Development Environment (IDE), a user can as 
easily navigate between page flows as between individual JSP pages. This allows 
you to group related web pages under one page flow, and create functionally 
modular web components. This approach to organizing the entities that comprise 
web applications makes it much easier to maintain and enhance web applications 
by minimizing the number of files that have to be updated to implement changes, 
and lowers the cost of maintaining and enhancing applications. 
[0020] Another advantage of page flows is that an instance of the page flow 
controller class is kept alive on a per-user-session basis while the user is 
navigating within the scope of the page flow. This instance ends when the user 
exits from the page flow. You can use instance member variables in page flow 
classes to hold user session state. 

[0021] Page flows can be the main part of a web application software 
engineering model that enables architects and developers to design and implement 
web applications by using an easy-to-understand, easy-to-maintain, fill-in-the- 
blanks pattern. Software architects may use page flows to design the overall 
structure of web applications and to create a fill-in-the-blanks skeletal version. For 
example, architects may create skeletal page flow classes that define only the basic 
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relationships among page flow files, temporarily containing only method 
signatures, and no method bodies. Developers may then fill in the empty method 
bodies of the page flow classes to complete the implementation of the web 
applications. 

[0022] In one embodiment, the system can be built on top of a general 
purpose framework, such as the Apache Struts Web Application Framework 
available from http://jakarta.apache.org/struts/. In one embodiment, a page flow is 
a Java class that controls the behavior of a web application through the use of 
specially designed annotations and methods. The directory that contains the page 
flow class also includes the JavaServer Pages (JSPs) used in the page flow. For a 
JSP to be considered part of a page flow, it can reside within the page flow 
directory. The JSP files use special tags which help bind to data and business logic 
actions. The actions in the JSP correspond to action methods that are defined in 
the page flow. These action methods implement code that can result in site 
navigation, passing data, or invoking back-end business logic. Significantly, the 
business logic in the page flow class is separate from the presentation code defined 
in the JSP files. 

[0023] In one embodiment, an IDE can provide graphical and code-level 
tools to simplify the development cycle. While page flows give you access to 
advanced features of J2EE, you do not have to be a J2EE expert to quickly develop 
and deploy Java-based applications built on page flows. Wizards can be used to 
create different types of page flows, generating the Java and JSP files that serve as 
a starting point for your work. Graphical tools let you draw the relationships 
between web components in a controller's Flow View. In Source View, syntax " 
completion, validation, and other programmer's aids reduce the amount of work 
required to get your application running. 

[0024] Figure 1 is an illustration of an exemplary IDE graphical view of an 
exemplary flow view in one embodiment. In the IDE, the tabs 122 at the bottom of 
the window can be used to switch between the graphical views and source view. 
When a page flow is open, its graphical representation is displayed in a Flow View 
window. The Action View (not shown) allows a programmer to focus on a 
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smaller portion of the page flow, for instance to examine a particular action and its 
form bean. The Source View (not shown) is where a programmer can customize 
the generated code and add business logic, or call controls that implement business 
logic. 

[0025] In one embodiment, all page flow controller classes have a begin 
action method 100 that can define what happens each time this page flow is 
navigated to from a web page. In one embodiment, each JSP file that resides in a 
page flow's directory is shown on the flow view, and is represented by a 
rectangular icon with a folded upper-right corner (e.g., 102, 106). Action methods 
are represented as circular icons (e.g., 100, 104, 108). Other page flows/page 
groups are represented by icon 1 10. In this non-limiting example, page_A . j sp 
102 is the first page that the user will see when the page flow's URL is accessed 
from a web browser. An arrow from an action icon to a JSP page icon indicates 
that the result of the action will load the target page (e.g., 112, 116). An arrow 
from a JSP page icon to an action icon indicates that the action is raised on the JSP 
page (e.g., 114, 118). An arrow from an action to another page flow indicates that 
the target page flow will be loaded (e.g., 120). The name of each action, page, or 
page flow can be shown below the icon. The name on the arrow next to the 
action's circular icon can correspond to the logical name of a Forward object that 
is returned by the action method. 

[0026] In this example, the page flow class defines an action method 104 
named toPageB. This action is raised by the JSP file page_A. j sp 102. For 
example, page_a.jsp could contain the following HTML code: 

<%@ taglib uri="netui-tags-html . tld" pref ix="netui"%> 
<h3>This is page_A. j sp</h3> 

<P> 

<netui : anchor action=" toPageB" >Link to 
page_B . j sp</netui : anchor> 

[0027] A special JSP tag library named netui - tags-html . tld is 
referenced. The <netui:anchor...> tag used here is simply associating an action 
with a hyperlink that it will generate. The toPageB action method is defined as 
follows: 

import com. bea . wlw. netui . pagef low. PageFlowController ; 
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import com.bea . wlw.netui .pagef low. Forward; 

public class Simplef lowController extends 
PageFlowCont roller 

{ 

I * * 

* @jpf : action 

* @jpf: forward name=" success" path= "page_B . j sp" 
*/ 

public Forward toPageB ( ) 

{ 

return new Forward ( "success" ) ; 

} 

} 

[0028] In one embodiment, action methods return objects of type 
com. bea . wlw.netui .pagef low. Forward. When the toPageB action is 
raised in page_A . j sp, the system detects the action and invokes the toPageB 
action method. This action method is coded to return a Forward object with the 
name "success". Notice that this name matches the name on the corresponding 
action arrow in Flow View. The two @ j pf tags that appear on the lines above this 
action method are annotations that are enclosed in Javadoc comments. The 
@ j pf : act ion tag indicates that the toPageB method is an action method. The 
@ j pf : forward tag describes the behavior of that method. 
[0029] A Forward object is returned by an action method to indicate to the 
page flow runtime that the action method wants the runtime to navigate to the 
location described by the Forward object. In this example, the Forward object 
passes the string "success", indicating that it should encapsulate the information 
provided in the @jpf : forward annotation (for this method) that has a name 
attribute of " success " . On this annotation, the path attribute is used. The path 
attribute's value is "page__B . j sp", which causes the page flow controller to 
load page_B . j sp. This is summarized in Figure 2. In one embodiment, the 
IDE can automatically generate the code in Figure 2 as a result of creating a new 
page flow or JSP file from the graphical view. 

[0030] In one embodiment, a page group is a logical grouping of related 
pages in a given web application. Page groups can serve the following purposes: 

• Control page flow between pages and other page groups. 

• Provide a way to group pages in a functional and/or logical way. 
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• Provide a place to write application logic that should be separate 
from the GUI, such as calling a server side control, web service, or 
EJB. 

[0031] Figure 3 is an illustration of exemplary page groups in an 
embodiment. From a design perspective page groups provide an ability to 
encapsulate a related set of functionality on a web site. For example, all of the 
pages involved in registering a new user for a site could be grouped together in a 
page group called "UserRegistration". When flowing to UserRegistration, other 
pages that refer to the UserRegistration page group don't have to worry about 
whether UserRegistration is a page or page group. They also don't have to know 
anything about business logic that may be executed by that page group. As Figure 
3 illustrates, page groups can have peer page groups and they can also contain other 
page groups, referred to as nested page groups. Nesting can be arbitrarily deep and 
each page group can contain either pages or child page groups or both. 
[0032] Figure 4 is another illustration of page groups in an embodiment. 
This figure shows how nested page groups could be used to allow a new user to 
register with the site during shopping/checkout. In this non-limiting example, a 
user who has been shopping 400 on a website decides to buy the items in his 
shopping cart. The user is an unknown user of the site, so the page flow sends him 
to the page group 404 where new users register with the web site. After this task 
has been accomplished, he is returned back to where he was in his checkout 
process 402, with all appropriate state maintained for that page group. 
[0033] In one embodiment, a page group can be represented by a Java class 
where page flow code and business logic coexist. Every time a page transition is 
initiated by a web browser user clicking a link or submitting a form, an application 
flow infrastructure can call a method on the appropriate page group to execute 
appropriate business logic and determine the destination page that should be shown 
to the user. These methods called by the application infrastructure are known as 
"commands". Commands are annotated to describe possible Destination objects 
that may be returned by the command, and they can return one of the Destination 
objects that they declare via those annotations. Destination objects are available as 
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class-scoped fields in the page group, which makes it easy for a destination to be 
returned. By way of a non-limiting example, such a class might appear as follows: 



public class MyGroup extends PageGroup 

{ 

I * * 

* ©pageName search results. jspx 

* @ pagePath */ 

SearchPageNode searchPage; 
/ * * 

* ©command Search 

* ©destination searchPage 
*/ 

* • * 

Destination search ( ) 

{ 

// No need to instantiate a new page 
// group object. We just use the one 
// declared in our page group, 
return searchPage; 

} 

} 

[0034] In a page flow, page groups can behave much like pages. In one 
embodiment, both pages and page groups have one begin node, and one or more 
end nodes. Page groups may be entered via: the page group's begin node or a link 
that goes directly to a page in another page group. The former is preferred where 
encapsulation is of the most importance, but the latter is not prohibited if a case 
arises where that is the most efficient way of handling a page transition. 
[0035] A page group can have multiple end nodes which can flow to different 
places. This is analogous to pages having many links which flow to different 
places. This similarity is beneficial from the standpoints of encapsulation and flow 
representation. From a flow representation standpoint this is nice because flows 
between pages and page groups have the same representation in the simplest case. 
From the encapsulation standpoint it is nice for the flow modeler to be able to treat 
both pages and page groups as interchangeable things. For example, a flow modeler 
could take a page and turn it into a page group (or vise versa) without affecting 
anything else in the flow. 

[0036] Figure 5 is an illustration of an exemplary IDE in an embodiment. In 
one embodiment, an DDE 500 can have one or more language modules 502 and one 
or more tool modules 504. Language modules and tool modules can integrate 
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themselves into the IDE via a common interface such as a service provider 
interface (SPI). Language modules provide services to the IDE, such as syntactic 
and semantic error checking, compilation, name space services and dependency 
analysis. Exemplary language modules can be provided for Java, XML and Java 
annotations. Tool modules provide tools for software developers, such as graphical 
editors, debuggers, class browsers, etc. Exemplary tool modules can include the 
flow view editor, action view editor, and source editor. 

[0037] Figure 6 is an illustration of an exemplary system in an embodiment. 
In one embodiment, controller 604 accepts a communication (e.g. an HTTP 
request) from browser 612. In one embodiment, the controller can be servlet. The 
controller accepts the request and determines which page 602 (e.g., JSP) to redirect 
or forward the request to based on a consultation with model 600. In one 
embodiment, the model can be implemented as one or more JavaBeans. The model 
contains the business logic of the application. The controller then transfers control 
to this page. The page flow model and the current page can interact with one or 
web services 606 and one or more databases 608 to perform business logic and 
other tasks. 

[0038] Page groups can be used to maintain application state. The system 
takes care of managing data and providing access to state variables in a page group 
through annotated variables declared in the page group. Page group variables can 
be annotated to be scoped to the request, session, or page group life. If a particular 
variable is not annotated with any scope then its scope will be that of the containing 
page group's lifetime. In the case of nested page groups, any page group scoped 
state will exist until that page group is no longer needed by the flow infrastructure 
(when flow has left one page group for another page group and won't be coming 
back as a result of nesting unwinding). 

[0039] A page flow is a Java class that controls the behavior of a web 
application through the use of specially designed annotations and methods. The 
directory that contains the page flow class also includes the JavaServer Pages 
(JSPs) used in the page flow. For a JSP to be considered part of a page flow, it can 
reside within the page flow directory. The JSP files use special tags which help 
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bind to data and business logic actions. The actions in the JSP correspond to action 
methods that are defined in the page flow. These actions methods implement code 
that can result in site navigation, passing data, or invoking back-end business logic 
via controls. Significantly, the business logic in the page flow class is separate from 
the presentation code defined in the JSP files. 

[0040] In one embodiment, a page group is a set of related and interacting 
web application files. The set of files in a page group includes *.jsp files and a Java 
controller class definition file that is specially named with a . pgr extension. By 
way of a non-limiting example, the set of files for a hiring wizard page group 
could be arranged in a web application hiringWizard file directory as 
illustrated in Figure 7. 

[0041] The term page group can be used in two ways. It can be used to refer 
to the directory and all of the files in a directory that make up a page group. It can 
also be used in a shorthand way to refer to the controller class defined in a page 
groups * . pgr file. By way of a non-limiting example, in the hiring wizard page 
group shown above, the term page group could be used to refer to the 
hiringWi zard directory and all five of the files contained in that directory, and 
the term could also be used to refer to just the HiringWizard controller class 
that is defined in the HiringWizard . pgr file. References to a page group's 
directory and files will be made in lower case and references to a page group's 
controller class will be made in upper case. By way of a non-limiting example, 
hiringWi zard refers to a directory and a set of files, whereas HiringWi zard 
refers to a Java class. 

[0042] Page groups enable developers to simplify the file and code 
organization of web applications. Developers may use page groups to organize the 
files of a web application into small, focused units. By way of a non-limiting 
example, a developer might organize the files of the human resources portion of a 
large web application into benefit sWi zard, help, hiringWizard, login, 
payAdjustment Wizard, stockPurchaseWizard and 

vacat ionWi zard page groups as shown in Figure 7. Developers may use page 
groups to remove code from * . j sp files and centralize the code into * . pgr files. 
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By way of a non-limiting example, a developer might centralize into the 
HiringWi zard . pgr file the navigation code that otherwise would have been 
spread out among the hiring wizard's name . j sp, jobDescription . j sp, 
error . j sp and confirmation . j sp files. 

[0043] Page groups can enable web application developers to implement 
powerful functionality with minimal effort. Developers may use instances of page 
group classes to hold and maintain information that is gathered from web site users 
at system. By way of a non-limiting example, a developer could use an instance of 
the HiringWi zard class to hold and maintain the name and job description 
information that would be gathered from users of the hiringWizard pages. 
Developers may use page groups to dynamically nest web site functionality within 
other web site functionality. By way of a non- limiting example, a developer could 
place Help buttons in the hiringWizard pages. When a hiring wizard user 
requests help by pressing one of the Help buttons, the system would dynamically 
nest a help page group within the hiringWi zard page group and navigate the 
user to the pages of the help page group. When the user presses an OK button in 
the help pages to indicate that they have completed their reading of the help 
pages, the system would un-nest the help page group and navigate the user back 
to their original location in the hiringWizard page group. Also, the system 
would restore all of the user's HiringWi zard state so that the user would return 
to the hiringWizard in exactly the same condition that they had left it when 
they pressed the Help button. 

[0044] Page groups can be the main part of a web application programming 
model that enables architects and developers to design and implement web apps 
using an easy-to-understand, easy-to-maintain, fill-in-the-blanks pattern. Architects 
may use page groups to design the overall structure of web applications and to 
create a fill-in-the-blanks skeletal version of web applications. By way of a non- 
limiting example, architects may create skeletal page group classes that define only 
the basic relationships among page group files and that contain only method 
signatures and no method bodies. Developers may then fill in the blank method 
bodies of the page group classes to complete the implementation of web apps. By 
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way of a non-limiting example, developers may fill in page group class method 
bodies to accomplish such detailed tasks as flowing data from one page to another 
page. 

[0045] In one embodiment, Page groups can interoperate with Struts code. 
The page group programming model offers the following advantages over the 
Struts programming model: 

[0046] ■ Thread safe. Instances of page group classes are accessed by the 

system in a single- threaded manner whereas instances of Struts action 
classes are accessed by the Struts framework in a multi-threaded 
manner. Unlike Struts developers, page group developers do not have 
to worry about threading issues when programming page group 
classes. 

[0047] ■ Elimination of multi-session use of instance members and action 

code. Instances of page group classes are dedicated to individual user 
sessions whereas instances of Struts action classes are shared across 
user sessions. Developers of page groups are guaranteed that a page 
group class's instance members and action code are not accessed by 
multiple sessions. 

[0048] ■ Statefulness. An instance of a page group class is kept alive on a 

per-user-session basis so long as a user is navigating within the scope 
of the respective page group, and is destroyed upon user exit from the 
respective page group. Unlike Struts action class developers, page 
group class developers may use instance members in page group 
classes to hold user session state. 

[0049] ■ Type strength. Instances of page group classes may contain 

instance members of arbitrary types, such as Customer or 
ShoppingCart , unlike Struts action classes which may not 
contain instance members and instead can depend upon type-less use 
of the Request and Session objects. Developers of page group 
classes will benefit from Workshop IDE features such as statement 

Attorney Docket No.: BEAS-01402US1 SRM/DJB Express Mail Label No.: EV3276221 88US 

djh^eas/1402USl application.doc 



13 

auto-completion that leverage the type strength of page group class 
instance members. 

[0050] ■ Useful constructors. Instances of page group classes are 

constructed upon entry into page groups and destroyed upon exit from 
page groups whereas instances of Struts action classes are constructed 
upon first use and are re-used thereafter. Developers of page groups 
are guaranteed that page group class constructors will be called upon 
entry to page groups, and that there will be only one entry to a page 
group per page group class constructor call. Therefore, developers of 
page groups may implement useful page group class constructors that 
perform such tasks as per-session page group initialization. 
[0051] ■ Better action method signatures. The system performs such tasks 

as casting action form arguments from the generic Struts 
ActionForm type to the more specific form type expected by the 
developers of the action methods. By way of a non- limiting example, 
the system would automatically cast an argument from the generic 
org . apache . struts . action .ActionForm type to a more 
specific com . acme . humanRe sources . Name Form type. This 
casting would relieve the action method programmer of the burden of 
performing the type cast. 
[0052] ■ Elimination of need to make configuration file entries. Page group 

classes are annotated Java classes. The annotations that are made in 
page group classes define such things as pages that maybe forwarded 
to by action methods. Developers of page group classes may use 
annotations to conveniently define in one place all of the relationships 
among the files of a page group, unlike developers of Struts 
applications who can write code in action class files and make entries 
in configuration files. 
[0053] In one embodiment, page group controller classes can be defined in 

files that are specially named with an extension of . pgr. The . pgr extension is 
used to indicate to an integrated development environment (IDE) that the files are 
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page group controller class definition files. The IDE can give special treatment 
such as two-way editing support to page group controller class definition files. The 
.pgr extension is also used to indicate to the system that the files are page group 
controller class definition files. The system can give special compilation and 
request dispatch treatment to controller class definition files. 
[0054] Annotations are provided for use in page group controller classes to 

declare important page group properties. Page group properties are used by the IDE 
to present graphical views of page groups. Page group properties are also used to 
indicate to the page group compiler information that the compiler needs to properly 
configure a page group for use. By way of a non-limiting example, a 
©pgr : act ion annotation is used to indicate to the page group compiler that it 
should make the corresponding page group method available for request by users of 
browser pages. 

[0055] There are several annotations available for use in page groups. Most 

of the annotations are described in the non-limiting examples in that follow. All of 
the annotations are fully defined in the reference section of this specification. 
[0056] All page group classes can be derived from a common class, e.g. 

com . bea . wlw . netui . pagegroup . PageGroup. By way of anon-limiting 
example, a HiringWizard page group class could be defined as: 

package hiringWizard; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
public class HiringWizard extends PageGroup 

{ 

• » * * 

} 

[0057] Page group classes contain user interface control logic. User 

interface control logic is logic that implements navigation decisions, that flows 
data into and out of pages and that invokes back-end business logic via calls to 
business controls. User interface control logic is implemented in page group classes 
within action methods. Action methods are methods that are annotated with 
©pgr : action and that have signatures that look like the namePage_next 
method of the following code: 
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package hiringWizard; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 

public class HiringWizard extends PageGroup 

{ 

I * * 

* ©pgr : action 

*/ 

public Forward namePage next ( ) 
{ 

• * « 

} 

} 

[0058] In one embodiment and as shown by the code example above, action 

methods can return objects of type com. bea . wlw . netui . pagegroup . 
Forward. An example of the action method namePage_next returning a 
Forward object: 

package hiringWizard; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 

public class HiringWizard extends PageGroup 

{ 

I * * 

* ©pgr taction 

* ©pgr: forward name="get JobDesc" 
path=" jobDescription. j sp" 

*/ 

public Forward namePage_next ( ) 

{ 

• * « 

return new Forward ( "get JobDesc" ) ; 

} 

} 

[0059] A Forward object is returned by an action method to indicate to 

the system that the action method wants the system to navigate to the location 
described by the Forward object. In the example, the Forward object 
encapsulates the navigation information needed by the system to navigate to the 
page j obDescription . j sp. The Forward object can be constructed by 
passing the string "getJobDesc" to the Forward constructor. This indicates to the 
Forward object that it should encapsulate the information provided in the 
©pgr : forward annotation that has a name attribute of "getJobDesc." 
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[0060] An action method may receive a form argument that encapsulates 

the data that was posted to the action method's page group by a browser user. By 
way of a non-limiting example, the namePage_next action method may receive 
an argument form that is of type NameForm: 

package hiringWizard; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 

public class HiringWizard extends PageGroup 

{ 

I * * 

* ©pgr: action 

* ©pgr: forward name=" get JobDesc" 
path=" jobDescription . j sp" 

*/ 

public Forward namePage_next (NameForm form) 

{ 

• * • 

return new Forward ( "get JobDesc" ) ; 

} 

} 

[0061] Figure 8 is an exemplary form rendered in a web browser in an 

embodiment. The form argument would encapsulate information such as first 
name and last name that was received from the browser user who filled out the 
fields (800 and 802) of the name . j sp page and pressed the name . j sp's Next 
button 804. 

[0062] A form class may be defined in its own . j ava file, or may instead 

be defined as an inner class within a page group class. By way of a non-limiting 
example, the NameForm class maybe defined with the HiringWi zard class as 
follows: 

package hiringWizard; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 
import com . bea . wlw . netui . pagegroup . Form ; 

public class HiringWizard extends PageGroup 

{ 

/ * * 

* ©pgr raction 

* ©pgr: forward name=" get JobDesc" 
path=" jobDescription . j sp" 

*/ 
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public Forward namePage_next (NameForm form) 
{ 

• ■ • 

return new Forward ( "get JobDesc" ) ; 

} 

public static class NameForm extends Form 

{ 

protected String firstName; 
protected String lastName; 

public String getFirstName ( ) 

return firstName ; 



public void setFirstName (String firstName) 
this . firstName = firstName; 



public String getLastName ( ) 
return lastName; 



public void setLastName (String lastName) 
this . lastName = lastName; 

} 

} 

[0063] The system keeps an instance of a page group class alive for a 

browser user for the duration of time that the user is viewing pages within that page 
group. Because of this, a page group class can contain instance members that hold 
some of a user's session information, and an action method can copy user 
information from its form argument to the instance members. By way of a non- 
limiting example, the namePage_next action method can copy first name and 
last name information from the properties of the form argument to firstName 
and lastName instance members: 

package hiringWizard; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 
import com .bea.wlw. netui . pagegroup . Form ; 

public class HiringWizard extends PageGroup 

{ 

protected String firstName; 
protected String lastName; 
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/ ★ * 

* ©pgr: action 

* ©pgr: forward name = " ge t JobDe s c " 
path=" j obDescription . j sp" 

*/ 

public Forward namePage_next (Name Form form) 

{ 

firstName = f orm. getFirstName ( ) ; 
lastName = f orm . getLastName { ) ; 

return new Forward ( "get JobDesc" ) ; 

} 

* 

■ • ■ 

} 

[0064] Pages of page groups can be used to display data to users and to 

collect data from users. In order for a page to bind to data, data can be made 
available to that page before forwarding to that page. Therefore, an action method 
can make data available to the page indicated by the Forward object returned by 
that action method. By way of a non-limiting example, the action method 
namePage_next can make data such as a default start date (e.g. two weeks from 
today) available to the job description page indicated by the "getJobDesc" 
Forward object. The most common way that action methods will make data 
available to pages is via Form-derived objects. By way of a non-limiting example, 
the namePage_next action method could make data such as the default start 
date available to the job description page by passing an instance of the 
JobDescript ionForm class to the job description page via the constructor of 
the "getJobDesc" Forward object: 



package hiringWizard; 
import j ava . util . Date ; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 
import com . bea . wlw . netui . pagegroup . Form ; 

public class HiringWizard extends PageGroup 

{ 

protected String firstName; 
protected String lastName; 

/ * * 

* ©pgr: action 

* ©pgr : forward name= "getJobDesc" 
path=" j obDescription . j sp" 

*/ 

public Forward namePage_next (NameForm form) 
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{ 

firstName = f orm . get Firs tName () / 
lastName = f orm . getLastName ( ) ; 

JobDescriptionForm j obDescForm = new 
JobDescriptionForm ( ) ; 

return new Forward ( "get JobDesc" , j obDescForm) ; 

} 

• * * 

public static class JobDescriptionForm extends Form 

{ 

protected String title = w " ; 

protected Date startDate = getDef aultStartDate () ; 
public String getTitleO 

return titled- 
public void setTitle (String title) 

this, title = titled- 
public Date getStartDate ( ) 

return startDate; 

public void setStartDate (Date startDate) 
this . startDate = startDate; 

protected Date getDef aultStartDate ( ) 



[0065] In one embodiment, a set of JSP tags can be used by page 

developers to bind pages to web application data sources. The 
jobDescription. j sp page of the hiringWizard page group could use 
these tags, By way of a non-limiting example, to bind to the data of the 
JobDescriptionForm (see Figure 8) provided to the page by the 
namePage_next action method. By way of a non-limiting example, the 
j obDescript ion . j sp page could use data-bound tags such as the <netui - 
tags-html : textbox> tag to bind to the title and startDate properties 
of the JobDescriptionForm object. (See Figure 9.) 
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[0066] As described earlier, because an instance of a page group class can 

be maintained for the duration of time that a user is navigating within the pages of 
the page group class's group, an instance of a page group class is a convenient place 
to accumulate and reuse information gathered from a user. By way of a non- 
limiting example, after a user has navigated through the name . j sp page to the 
j obDescr ipt ion . j sp page, a user might want to push a Previous button to 
go back to the name . j sp page to correct the First Name or Last Name 
fields. The first name and last name that had been collected from the user when the 
user first submitted the name . j sp page could be made available to the 
name . j sp page again for binding and re-display to the user: 



package hiringWizard; 
import j ava . util . Date ; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 
import com. bea . wlw . netui . pagegroup . Form; 

public class HiringWizard extends PageGroup 

{ 

protected String firstName; 
protected String lastName; 
protected String title; 
protected Date startDate; 

/ * * 

* ©pgr: action 

* ©pgr; forward name="get JobDesc" 
path=" j obDescript ion . j sp" 

*/ 

public Forward namePage_next (NameForm form) 

{ 

firstName = f orm . getFirstName ( ) ; 
lastName = f orm. getLastName ( ) ; 

JobDescriptionForm jobDescForm = new 
JobDescriptionForm ( ) ; 

return new Forward ( "get JobDesc" , jobDescForm); 

} 

j * * 

* ©pgr: action 

* ©pgr: forward name =" get Name" path="name . j sp" 
*/ 

public Forward j obDescPage_previous (JobDescriptionForm 
form) 

{ 

title = f orm . getTitle ( ) ; 
startDate = f orm. getStartDate ( ) ,- 
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NameForm nameForm = new Name Form () / 
nameForm. setFirstName (f irstName) ; 
nameForm. setLastName (lastName) ; 

return new Forward ( "getName" , nameForm) ; 



[0067] Just as an instance of a page group can be used to accumulate 

information to enable backwards navigation flow through some pages, the instance 
can be used to accumulate information to enable the presentation of a 
summary/confirmation page: 

I * * 

* ©pgr: action 

* ©pgr: forward name=" get Confirm" path=" confirmation . j sp" 

*/ 

public Forward j obDescPage_next ( JobDescript ionForm form) 

{ 

title = f orm.getTitle ( ) ; 
startDate = f orm. getStartDate ( ) ; 

HireForm hireForm = new HireForm (); 
hireForm. setFirstName (f irstName) ; 
hireForm. setLastName (lastName) ; 
hireForm. setTitle (title) ; 
hireForm. setStartDate (startDate) ; 

return new Forward ( "getConf irm" , hireForm); 

} 

public static class HireForm extends Form 

{ 

protected String f irstName; 
protected String lastName; 
protected String title; 
protected Date startDate; 

public String getFirstName ( ) 

return f irstName; 



public void setFirstName (String f irstName) 
this . f irstName = f irstName; 



public String getLastName ( ) 
return lastName; 



public void setLastName (String lastName) 
this . lastName = lastName; 



public String getTitleO 
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return title; 



public void setTitle (String title) 
this. title = title; 



public Date getStartDate ( ) 
return startDate; 



public void setStartDate (Date startDate) 
this . startDate = startDate; 

} 

} 

[0068] A principal benefit of page group classes is that they provide a 

central location for placement of code that interacts with back-end business logic. 
In web applications, interactions with back-end business logic can be performed via 
business controls. Code that interacts with business logic would typically be placed 
in action methods. By way of a non-limiting example, the code to initiate a 
workflow to hire a new employee could be placed in an action method called 
conf irmationPage_hire: 

I * * 

* ©pgr: action 

* ©pgr: forward name=" readyForNextCandidate" 
path="name . j sp" 

*/ 

public Forward conf irmationPage_hire (HireForm form) 

{ 

hiringService . hire ( f orm. get Firs tName ( ) , 

f orm . getLastName ( ) , 
f orm . getTitle ( ) , 
form . getStartDate () ) ; 

f irstName = null ; 
lastName = null; 
title = null; 
startDate = null; 

Name Form name Form = new Name Form ( ) ; 

return new Forward ( "readyForNextCandidate" , nameForm) ; 

} 
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[0069] The conf irmat ionPage_hire action method initiates a hiring 

workflow by calling the hire method of the HiringService control. The 
action method makes the call to the hire method with the f irstName, 
lastName, j obDescription and startDate properties oftheHireForm 
argument that it received from the confirmation . j sp page. If the user filled 
out the forms of the name . j sp and j obDescription . j sp pages correctly, 
then the properties of the HireForm argument should be good enough to 
successfully initiate the hiring workflow. However, if the user did not correctly fill 
out either or both of the name . jsp and jobDescription.jsp forms, then the 
HiringService will reject the attempt to initiate a workflow. 
[0070] The page group framework provides support that makes it easy to 

re-show error-containing pages immediately after they have been submitted. The 
page re-show support is based upon a form validation model. The form validation 
model is based upon the request processing cycle. Every browser request that is 
received by the system is processed through several steps. 

[0071] The system performs the first step in the cycle by using the name- 

value pairs in the request to make property assignments to an instance of the 
appropriate Form class for that request. By way of a non-limiting example, if a 
user presses the Next button on the name . j sp page, the browser submits a 
request to the system. In response, the system creates an instance of the 
Name Form class and uses the f irstName =" John" and lastName = / 'Doe // 
name-value pairs in the request to assign "John" and "Doe" to the instance's 
f irstName and lastName properties. 

[0072] In one embodiment, the system performs the next step in the cycle 

by calling the Form instance's validate method. The validate method 
validates the properties of the Form instance, and returns an instance of an 
Errors collection object if the val idat e method finds any validation errors. In 
one embodiment, all Form-derived classes inherit an empty implementation of 
validate from the base Form class. The empty implementation never reports 
errors and always returns an empty Errors collection. All Form-derived classes 
are free to override the validate method to implement their own validation 
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behavior. By way of a non-limiting example, the NameForm class could override 
the validate method as follows: 

public static class NameForm extends Form 

{ 

protected String firstName = w "; 
protected String lastName = ""; 



public Errors validate () 

{ 

Errors errors = new Errors ( ) ; 
if (firstName == null) 

{ 

errors . add (new Error ( "firstName is required"); 

} 

if (lastName == null) 

{ 

errors . add (new Error ( "lastName is required"); 

} 



} 



} 



return errors; 



[0073] In this case, if the browser request from name . j sp does not 

contain both firstName and lastName name- value pairs, then the NameForm 
instance will not pass validation and will return an Errors collection that 
contains Error objects for each of the missing properties. 
[0074] When the system calls a Form instance's validate method and 

receives a non-empty Errors collection, then the system short-circuits the normal 
request processing cycle. Instead of calling an action method in a page group to 
process the request, the system forwards to the page that submitted the bad request 
so that the page may be re-shown to the user with error messages. By way of a non- 
limiting example, if the user filled out the name . j sp page's First Name field 
but did not fill out the Last Name field prior to pressing the Next button, the 
NameForm instance would fail validation and the system would automatically re- 
show the name . j sp page to the user with an error message explaining that the 
Last Name field is required. 

[0075] The system provides a declarative alternative to the validate method 

technique described above. Instead of (or in addition to) implementing a validate 
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method, it is possible to annotate Form classes to express the validation checks that 
would have been encoded in the validate method. By way of a non-limiting 
example, the NameForm class could be annotated as follows: 

I * * 

* ©pgr : validation property=" f irstName" 

* required=" true" 

* pattern="TBD" 

* ©pgr : validation property=" lastName" 

* required=" true" 

* pattern="TBD" 

*/ 

public static class NameForm extends Form 

{ 

protected String f irstName = w " ; 
protected String lastName = ""; 



} 

[0076] The page group compiler will generate validation code for each of 

the validation checks described with ©pgr : validation annotations. The 
system will execute the validation code after calling the validate method, and 
will add any Error objects to the same Errors collection object that is returned 
by the validate method. 

[0077] Like most Java code, code in page group controller classes may 

have to catch and handle exceptions. In regular Java code, exceptions would be 
caught and handled by catch clauses within method bodies. Page group action 
methods may be written to use the same type of catch clauses. By way of a non- 
limiting example, to catch and handle exceptions thrown by the workflow business 
control, a catch clause could be added to the conf i rma t i onPage_hi re 
action method: 



/ * * 

* ©pgr: action 

* ©pgr: forward name=" readyForNext Candidate" 
path="name . j sp" 

* ©pgr: forward name=" error" path=" error . j sp" 
*/ 

public Forward conf irmationPage_hire (HireForm form) 

{ 

try 

{ 

hiringService . hire (f irstName, lastName, title, 
startDate) ; 

} 

catch (Exception e) 
{ 
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// TODO: Add code to handle exception 
return new Forward ( "error" ) ; 

} 

firstName = null; 
lastName = null; 
title = null; 
startDate = null; 

Name Form name Form = new Name Form (); 

return new Forward ( "ready ForNextCandidate " , nameForm); 



[0078] To improve the quality of an DDEs view of application flow and 

because many corporate developers are unfamiliar with try/catch programming and 
are instead familiar with onError programming, the system supports an 
alternative model for catching exceptions. The conf irmat ionPage_hire 
action method can be annotated with ©pgr : cat ch 5 and the method signature can 
be extended to include a throws clause. Because of the changes to the action 
method, the system will catch all exceptions thrown by the method and will 
forward to the error . j sp page that is identified in the path attribute of the 
©pgr : catch annotation. Also in the example above, because the system catches 
the exceptions thrown by the conf irmat ionPage_hi re method, the 
HiringWi zard page group does not get an opportunity to handle the exceptions. 

I * * 

* ©pgr: action 

* ©pgr : forward name=" readyForNextCandidate" 
path="name . j sp" 

* ©pgr: catch type=" com. acme . Workf lowExcept ion" 
path=" error . j sp" 

*/ 

public Forward conf irmat ionPage_hi re (HireForm form) 
throws Exception 

{ 

hiringService .hire (firstName, lastName, title, 
startDate) ,* 

firstName = null; 
lastName = null; 
title = null; 
startDate = null; 

NameForm nameForm = new Name Form (),- 

return new Forward ( "readyForNextCandidate" , nameForm); 
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[0079] The system provides yet another alternative for catching and • 

handling exceptions: 

I * * 

* ©pgr : except ionHandler 

* ©pgr: forward name="error" path="error . j sp" 
*/ 

protected Forward onError (Exception e, 

String errorMethodName , 
String messageKey, 
String message, 
Form form) 

{ 

// TODO : Add some code to handle error 
return new Forward ( "error" ) ; 

} ■ 

[0080] Nesting is a feature that enables web sites to support such things as 

user navigation from a location in a first page group to a location in a second page 
group and back to the first page group. Nesting enables web sites to support user 
navigation from a location in a nesting page group to a location in a nested page 
group and back to the nesting page group. By way of a non-limiting example, the 
nesting feature enables user navigation from the hiringWizard's 
j obDe script ion . j sp page to a page in the help page group and back to the 
j obDescription . j sp page, with all of the user's j obDescription . j sp 
information such as Job Description and Start Date intact. 
[0081] In one embodiment, nesting occurs when an action method in a 

nesting page group returns a Forward object that refers to another page group that 
is nestable. As described earlier, the system keeps a page group instance alive for 
the duration of time that a user is navigating within the pages of that page group. 
By way of a non-limiting example, the system would keep an instance of the 
HiringWizard page group alive while a user was navigating through the 
name . j sp, j obDescription . j sp and confirmation . j sp pages. By 
keeping a page group instance alive, the system keeps alive user state such as the 
HiringWizard instanced f irstName and title that is gathered by the 
pages of that page group. The system only disposes of a page group instance and 
that page group instance's user state when a user navigates out of the page group. 
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[0082] When a page group nests a second page group, the nesting page 

group instance is kept alive while the user is navigating the pages of the nested 
page group. Upon user return to the nesting page group the nested page group 
instance is disposed. 

[0083] By way of a non-limiting example, if from within the 

hir ingWi zard page group a user pressed a Help button to cause nesting of the 
help page group, the user would then be in the help page group. Upon return to 
the hir ingWi zard page group, the user would no longer be in the help page 
group, and would only be in the hiringWi zard page group. 
[0084] In one embodiment, the system can keep page group instances alive 

by keeping them on a session-based page group stack. Whenever a user enters a 
page group, the system can push the page group instance onto the stack. When the 
user exits the page group, the system can pop the page group instance off of the 
stack. 

[0085] By way of a non-limiting example, if a user entered the 

hiringWi zard page group, the system would push the HiringWi zard page 
group instance onto the stack. If the user then pressed a Help button to cause the 
help page group to be nested, then the system would push the Help page group 
instance onto the top of the page group stack. Upon return from the nested help 
page group to the hiringWi zard page group, the system would pop the Help 
page group instance from the page group stack. 

[0086] In one embodiment, there are at least three web site scenarios that 

are supported by the nesting feature. The first scenario is the one already 
mentioned: a web site can support user navigation from a location in the web site, 
to a second location in the web site and then back to the first location in the web 
site with all first-location state intact. The second scenario is one in which the 
developers of a site use a page group in the same way that they use a page. In this 
scenario, the nested page group may be viewed as participating in the flow of the 
nesting page group. An example of this scenario is the case where the developers of 
the hiringWi zard page group replace the name . j sp page with an 
employeelnf oWi zard page group that uses a sequence of pages to collect not 
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only the name, but also things like address, telephone number and email address. 
The third scenario is one in which a page group can support interruption of a web 
flow to ensure that some important preconditions are met before continuing the 
web flow. An example of this scenario is the case where in the middle of some web 
flow the page group logic determines that a user login can occur, so the logic 
diverts to some login pages and upon completion of the login returns to complete 
the interrupted web flow. 

[0087] By way of a non-limiting example of the web site scenario where a 

web site can support user navigation from a location in the web site, to a second 
location in the web site and then back to the first location in the web site with all 
first-location state intact. In this example, the humanResources web application 
contains a help page group 1000 (See Figure 10). 

[0088] While navigating through the pages of the hiringWi zard page 

group, a user might request help by pressing the Help 806 button on the 

jobDescription . j sp page (see Figure 8). Pressing the Help button on the 

j obDescript ion . j sp page could cause the execution of a 

j obDescript ionPage_help action method in the HiringWi zard page 

group class: 
I * * 

* ©pgr: action 

* ©pgr: forward name =" get Help" path=" /help/Help . pgr" 
*/ 

public Forward j obDescriptionPage_help ( ) 

{ 

return new Forward ( "getHelp" ) ; 

} 

[0089] The j obDescript ionPage__help action method forwards to 

the help page group. Note that the path attribute of the 
j obDescript ionPage_help method's ©pgr : forward annotation refers to 
the path /help/Help . pgr. This path is special in two ways. First, it begins with 
a forward slash. This indicates to the system that the path should not be interpreted 
in the default page group relative fashion and instead should be interpreted relative 
to the web application root. Second, the path ends with a . pgr extension and 
refers to a page group class definition file instead of to a page file. 
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[0090] Like the HiringWizardpage group, the Help page group can be 

defined as an annotated Java class: 



package help; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
public class Help extends PageGroup 

{ 

• * m 

} 

[0091] Unlike the HiringWi zarcl page group, the Help page group can 

be specially annotated to indicate that it should be nested whenever it is used: 



package help; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
I * * 

* ©pgr : nestable 
*/ 

public class Help extends PageGroup 

{ 

* • » 

} 

[0092] When the system forwards to the Help page group, the system 

pushes the Help page group instance onto the page group stack. Then the system 
will look for, select and execute the Help page group's action method that is 
specially marked with the @pgr : begin annotation: 



package help; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 

I * * 

* ©pgr : nestable 
*/ 

public class Help extends PageGroup 

{ 

/ * * 

* ©pgr : begin 
*/ 

public Forward begin ( ) 
{ 
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[0093] Although not shown in the previous examples, all page group 

controller classes can contain begin methods. And the begin methods of page 
group controller classes are always executed by the system upon entry to a page 
group. The begin action method of the Help page group could return a forward 
object that represents the default page of the Help page group: 



package help; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 

/ * * 

* ©pgr : nestable 
*/ 

public class Help extends PageGroup 

{ 

/ * * 

* ©pgr : begin 

* ©pgr: forward name =" default Page" path=" index . j sp" 
*/ 

public Forward begin ( ) 

{ 

return new Forward ( "def aultPage" ) ; 

} 

} 

[0094] The default page (index . j sp) is illustrated in Figure 11. As can 

be seen, the help page group's default page is just that. It includes a table of 
contents for the help page group, and merely enables a web site user to select a 
help topic. However, for the example of a user that pressed a Help button on the 
j obDescription . j sp page of the hiringWizard page group, there 
shouldn't be a need for a user to have to select a help topic from a table of contents. 
Instead, since the help context (hiringWizard page group) is already known, 
the help page group should be directed to automatically forward to the relevant 
help page. To enable nesting page groups such as HiringWi zard to select help 
contexts, the Help page group can make something like a HelpContextForm 
class available that provides help context ids and a contextld property: 



package help; 

import com . bea . wlw . netui . pagegroup . PageGroup / 
import com . bea . wlw . netui . pagegroup . Forward ; 

I * * 

* ©pgr : nestable 
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*/ 

public class Help extends PageGroup 
{ 

J * * 

* ©pgr: begin 

* ©pgr: forward name=" default Page" path=" index . j sp" 
*/ 

public Forward begin ( ) 

{ 

return new Forward ( "def aultPage" ) ; 

} 

public static class HelpContextForm extends Form 

{ 

public static final int BENEFITS = 0; 

public static final int H I R ING_W I Z ARD = 1; 

public static final int PA Y_AD JUS TMENT_W IZARD = 2; 

public static final int S TO CK_PURCHASE_W IZARD = 3; 

public static final int VACATION_WIZARD = 4; 

protected int helpContextld; 

public int getHelpContextld ( ) 

{ 

return helpContextld; 

} 

public void setHelpContextld (int helpContextld) 

{ 

this . helpContextld = helpContextld; 

} 

} 

} 

[0095] Given the availability of the HelpContextForm class, the 

j obDescriptionPage_help action method could then be modified to pass 
help context information to the Help page group via the Forward: 

I * * 

* ©pgr : action 

* ©pgr : forward name-" get Help" path=" /help/Help . pgr" 

*/ 

public Forward jobDescriptionPage help ( ) 
{ 

Help . HelpContextForm helpForm = new 
Help . HelpContextForm ( ) ; 

helpForm. setHelpContextld (Help . HelpContextForm. HIRING^ 
WIZARD) ; 

return new Forward ( "getHelp" , helpForm); 

} 

[0096] With the j obDescriptionPage_help action method passing 

the HelpContextForm object, the begin action method of the Help page 
group could be modified to select the help page that makes the most sense: 
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package help; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 

I * * 

* ©pgr : nestable 
*/ 

public class Help extends PageGroup 

{ 

I * * 

* ©pgr: begin 

* ©pgr: forward name="def aultPage" path=" index . j sp" 

* ©pgr : forward name="benef itsHelp" path="benef its . j sp" 

* ©pgr: forward name="hiringHelp" path="hiringWizard . j sp" 

* ©pgr : forward name ="payAd just Help" 
path="payAdjustWizard . j sp" 

* ©pgr : forward name=" stockPurchHelp" 
path=" stockPurchWizard . j sp" 

* ©pgr: forward name="vacationHelp" 
path="vacationWizard . j sp" 

*/ « 

public Forward begin (HelpContextForm form) 

{ 

switch (form. getHelpContext Id ( ) ) 

{ 

case HelpContextForm. BENEFITS : 

return new Forward ( "benef itsHelp" ) ; 

case HelpContextForm. HIRING_WIZARD : 
return new Forward ( "hiringHelp" ) ; 

case HelpContextForm. PAY_ADJUSTMENT_W IZARD : 
return new Forward ( "payAd jus tHelp" ) ; 

case HelpContextForm. STOCK_PURCHASE_WIZARD: 
return new Forward ( "stockPurchHelp" ) ; 

case HelpContextForm. VACATION_WIZARD : 
return new Forward ( "vacationHelp" ) ; 

default : 

return new Forward ( "def aultPage" ) ; 

} 

} 



public static class HelpContextForm extends Form 

{ 

public static final int BENEFITS = 0; 

public static final int HIRING_WIZARD = 1; 

public Static final int PAY_ADJUSTMENT_W IZARD = 2; 

public static final int STOCK_PURCHASE_WIZARD = 3; 

public static final int VACATION_WIZARD = 4; 

protected int helpContextld; 

public int getHelpContextld ( ) 

{ 

return helpContextld; 

} 

public void setHelpContextld ( int helpContextld) 
{ 
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this . helpContextld = helpContext Id; 



[0097] The hiringWi zard . j sp page can contain a Done button. When 

the user presses the Done button, the Help page group's 

hiringHelpPage_done action method is invoked. Like all action methods, the 

hiringHelpPage__done action method returns a Forward object. Unlike 

most action methods, however, the hiringHelpPage_done action method 

returns a Forward object that encapsulates a ©pgr : forward annotation that 

does not have a path attribute: 
I * * 

* ©pgr: action 

* ©pgr: forward name = " done " returnAction="help_done" 

*/ 

public Forward hiringHelpPage_done ( ) 

{ 

return new Forward ( "done" ) ; 

} 

[0098] The hiringHelpPage done action method returns a Forward object 

that encapsulates a @pgr : forward annotation that has a returnAction 
attribute. The presence of this attribute changes the meaning of the 
©pgr : forward annotation significantly. Because of this attribute, the annotation 
describes a return from the nested Help page group to the nesting 
HiringWi zard page group. In short, the hiringHelpPage_done action 
method returns a Forward object that causes a return from the nested Help page 
group to the nesting HiringWi zard page group. 

[0099] The system responds to the Forward object by popping the nested 

Help page group instance off of the page group stack, which leaves the nesting 
Hiring Wizard page group instance as the only instance on the page group stack. 
Then, per the returnAction="help_done" attribute of the Help page 
group, the system executes the help_done action method in the 
HiringWi zard page group: 

I * ★ 

* ©pgr: action 
*/ 
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public Forward help doneO 
{ 

• « • 

} 

[0100] The help_done causes a return to the original page, 

j obDescript ion . j sp, by returning a Forward object that encapsulates a 
©pgr : forward annotation that describes a return to the original page. The 
©pgr : forward annotation describes a return to the original page because instead 
of having a path attribute, it has a returnTo attribute setting of page. When 
the system receives a Forward object that encapsulates a returnTo="page" 
attribute, the system automatically forwards to the page that was last used by the 
page group. Also, when forwarding to the original page, the system passes along 
the Form object that was originally submitted by the page when the page initiated 
the nesting in the first place. By way of a non-limiting example, when forwarding 
back to the j obDescript ion . j sp page, the system forwards along the 
JobDescriptionForm object that had been submitted to the 
j obDescript ionPage__help action method that nested the Help page group. 

* 

Because of this, the j obDescript ion . j sp page will be completely restored to 
the condition that it was in when the user pressed the Help button. 
[0101] By way of a non-limiting example of the scenario where a page 

group is used in the same way that a page would be used, an employeelnfo Wizard 
page group is added to the application to gather data in the same way that the 
hi r ingWi zard page group's name . j sp page gathered data. To begin with, an 
employeelnf oWizard page group is added to the application. The 
employee Inf oWi zard page group contains pages that gather not only name 
information but also address and contact information. The Employeelnfo Wizard 
page group is a nestable page group and is therefore declared to be nestable with an 
annotation: 

package employeelnf oWi zard; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com. bea . wlw. netui .pagegroup . Forward; 

I * * 

* ©pgr : nestable 
*/ 
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public class Employee InfoWizard extends PageGroup 



[0102] An Employeelnf oWi zard page group has a begin method that 

accepts an Employeelnf oForm, uses the Employeelnf oForm to initialize 
the page group and then forwards to the employeelnf oWi zard group's 
name . j sp page: 

package employeelnf oWizard; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 
import com . bea . wlw . netui . pagegroup . Form; 

* ©pgr : nestable 
*/ 

public class Employeelnf oWi zard extends PageGroup 

{ 

protected String firstName; 
protected String lastName; 
protected String street; 
protected String city; 
protected String state; 
protected String zip; 
protected String homeTelephone ; 
protected String workTelephone ; 
protected String email; 

j * * 

* ©begin 

* ©pgr : forward name="getName" path="name . j sp" 
*/ 

public Forward begin (Employeelnf oForm form) 

{ 

firstName = form. get FirstName () ; 
lastName = form . getLastName ( ) ; 
street = form.getStreet () ; 
city = f orm. getCity ( ) ; 
state = f orm . getState ( ) ; 
zip = f orm. getzip ( ) ; 

homeTelephone = f orm . getHomeTelephone ( ) ; 
workTelephone = f orm . getWorkTelephone ( ) ; 
email = f orm . getEmail ( ) ,- 

return new Forward ( "getName" ) ; 

} 

public static class Employeelnf oForm extends Form 

{ 

protected String firstName; 

protected String lastName; 

protected String street; 

protected String city; 

protected String state; 

protected String zip; 

protected String homeTelephone; 
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protected String workTelephone ; 
protected String email; 

public String getFirstName ( ) 

return firstName; 

public void setFirstName (String firstName) 
this . firstName; 

public String getLastName ( ) 
re turn las tName ; 

public void setLastName (String lastName) 
this . lastName = lastName; 

public String getStreetO 
return street; 

public void setStreet (String street) 
this. street = street; 

public String getCityO 
return city; 

public void setCity (String city) 
this. city = city; 

public String getStateO 
return state; 

public void setstate (String state) 

this, state = stated- 
public String getZipO 

return zip; 

public void setZip ( String zip) 
this . zip = zip ; 
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public String getHomeTelephone ( ) 
return homeTelephone; 



public void setHomeTelephone (String homeTelephone) 
this . homeTelephone = homeTelephone; 



public String getWorkTelephone ( ) 
return workTelephone ; 



public void setWorkTelephone (String workTelephone) 
this . workTelephone = workTelephone; 



public String getEmailO 
return email; 

public void setEmail (String email) 
this . email = email ; 

} 

} 

[0103] Next, the HiringWizard page group is modified to nest the 

employeelnf oWizard page group instead of forwarding to the 
hiringWizard page group's name.jsp page: 



package hiringWizard; 
import j ava . util .Date; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 
import com . bea . wl w . netui . pagegroup . Form ; 

import hiringService . HiringService ; 

import help. Help; 

import employeelnf oWizard . Employeelnf oWizard; 

public class HiringWizard extends PageGroup 

protected String firstName; 
protected String lastName; 
protected String title; 
protected Date startDate; 

/ * * 

* ©wlw: control 
*/ 

HiringService hiringService; 
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J * * 

* ©pgr: begin 

* ©pgr : forward name =" get Name" 
* 

path=" /employeelnf oWizard/Employeelnf oWizard .pgr" 
*/ 

public Forward begin ( ) 

{ 

Employeelnf oWizard . Employeelnf oForm form = 

Employeelnf oWizard . Employeelnf oForm ( ) ; 
form. setFirstName (f irstName) ; 
form. setLastName (lastName) / 

return new Forward ( "getName" , form); 

} 

I * * 

* ©pgr: action 

* ©pgr: forward name = " ge t J obDe s c " 
path=" j obDescript ion . j sp" 

*/ 

public Forward namePage_next (NameForm form) 

{ 

firstName = f orm. getFirstName ( ) ; 
lastName = f orm. getLastName ( ) ; 

JobDe s crip t ionForm jobDescForm = new 
JobDescriptionForm ( ) ; 

return new Forward ( "get JobDesc" , jobDescForm); 

} 

/ * * 

* ©pgr: action 

* ©pgr: forward name=" getName" 
★ 

path=" / employeelnf oWizard/Employeelnf oWizard . pgr" 
*/ 

public Forward jobDescPage_previous (JobDescriptionForm 
form) 

{ 

title = form. getTitle () ; 
t startDate = f orm. getStartDate ( ) ; 

Employeelnf oWizard . Employeelnf oForm form = 

Employeelnf oWizard . Employeelnf oForm ( ) ; 
form . setFirstName (firstName) ; 
form . setLastName ( lastName) ; 

return new Forward ( "getName" # form); 

} 

I * * 

* ©pgr: action 

* ©pgr : forward name="getConf irm" path=" confirmation . j sp" 
*/ 

public Forward jobDescPage next (JobDescriptionForm form) 

{ 

title = f orm . getTitle () ; 
startDate = form. getStartDate () ; 

HireForm hireForm = new HireFormO; 
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hireForm. setFirstName (f irstName) ; 
hireForm. setLastName (lastName) ; 
hireForm . setTitle (title) ; 
hireForm. setStartDate (startDate) ; 

return new Forward ( "getConf irm" , hireForm); 

} 

I * * 

* ©pgr: action 

* ©pgr: forward name=" readyForNextCandidate" 
* 

path=" /employeelnf oWizard/Employeelnf oWizard . pgr" 

* ©pgr: catch type =" com. acme . Workf lowExcept ion" 
method=" onError" 

*/ 

public Forward conf irmationPage_hire (HireForm form) 
throws Exception 

{ 

hiringService .hire (f irstName, lastName, title, 
startDate) ; 

f irstName = null ; 
lastName = null; 
title = null; 
startDate = null; 

Employeelnf oWizard . Employeelnf oForm form = 

Employeelnf oWizard . Employeelnf oForm ( ) ; 
form. setFirstName (f irstName) ; 
form . setLastName (lastName) ; 



} 
/ 



return new Forward ( "readyForNextCandidate" , form) ; 



* ©pgr taction 

* ©pgr: forward name="getHelp" path=" /help/Help . pgr" 
*/ 

public Forward j obDescriptionPage_help ( ) 

{ 

Help . HelpContextForm helpForm = new 
Help . HelpContextForm ( ) ; 

helpForm . setHelpContextld (Help . HelpContextForm. HIRING 
WIZARD) ; 

return new Forward ( "getHelp" , helpForm); 

} 

/ * * 

* ©pgr taction 

* ©pgr : forward name="returnToPage" returnTo="page" 

*/. 

public Forward help_done() 

{ 

return new Forward ( "re turnToPage" ) ; 

} 

/ * * 

* ©pgr : exceptionHandler 

* ©pgr: forward name=" error" path= " error . j sp" 
*/ 

protected Forward onError (Exception e, 
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{ 



String errorMethodName, 
String messageKey, 
String message, 
Form form) 



// TODO: Add some code to handle error 
return new Forward ( "error" ) ; 

} 

} 

[0104] Like the Help page group, the Employeelnf oWizard page 

group returns from nesting by having an action method return a Forward that 
encapsulates a returnAc t ion attribute. However, unlike the Help page group, 
the Employeelnf oWi zard page group returns data to its nester. To indicate to 
the system the type of the form that will hold the data to be returned, a 
returnFormType attribute is used: 

package employeelnf oWizard; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com. bea .wlw. netui .pagegroup . Forward; 
import com . bea . wlw . netui . pagegroup . Form ; 

I * * 

* ©pgr : nestable 

*/ 

public class Employeelnf oWizard extends PageGroup 
{ 

protected String firstName; 
protected String lastName; 
protected String street; 
protected String city; 
protected String state; 
protected String zip; 
protected String homeTelephone ; 
protected String workTelephone; 
protected String email; 

I * * 

* ©begin 

* ©pgr : forward name="getName" path="name . j sp 

*/ 

public Forward begin (Employeelnf oForm form) 

{ 

firstName = f orm. getFirstName ( ) ; 
lastName = form . getLastName ( ) ; 
street = f orm . getStreet ( ) ; 
city = f orm. getCity ( ) ; 
state = f orm . getState ( ) ; 
zip = f orm . getZip ( ) ; 

homeTelephone = f orm . getHomeTelephone ( ) ; 
workTelephone = f orm . getWorkTelephone ( ) ; 
email = f orm. getEmail ( ) ; 

return new Forward ( "getName" ) ; 
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} 

/ * * 

* ©pgr taction 

* ©pgr: forward name="done 

* returnAction=" employeelnf o_done 

* returnFormType="EmployeeInf oForm" 

*/ 

public Forward conf irmationPage__done ( ) 

{ 

Employeelnf oForm form = new Employeelnf oForm ( ) ,- 

form. setFirstName (f irstName) ; 

form. setLastName (lastName) ; 

form. setstreet (street ) ; 

form. setCity (city) ; 

form. setState (state) ; 

form . setZip (zip) ; 

form. setHomeTelephone (homeTelephone) ; 
form. setWorkTelephone (workTelephone) ; 
form . setEmail (email ) ; 

return new Forward ( "done" , form); 

} 

public static class Employeelnf oForm extends Form 

{ 

protected String f irstName; 

m » • 

public String getFirstName ( ) 

{ 

return f irstName; 

} 

public void setFirstName (String f irstName) 

{ 

this . f irstName; 

} 

• • • 

} 

} 

[0105] The HiringWizard page group can be modified to change the 

namePage_next action method that would have been invoked by the 
HiringWizard group's name . j sp page. The namePage_next action method 
is changed to be an employeelnf o_done action method that accepts an 
argument of type Employeelnf oWizard . Employeelnf oForm: 

package hiringWizard; 
import j ava . util . Date ; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 
import com . bea . wlw . netui . pagegroup . Form ; 
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import hiringService . HiringService ; 
import help. Help; 

import employeelnf oWizard . Employeelnf oWizard; 
public class HiringWizard extends PageGroup 

{ 

protected String firstName ; 
protected String lastName; 
protected String title; 
protected Date startDate; 

I * * 

* ©wlw: control 
*/ 

HiringService hiringService; 
I * * 

* ©pgr: begin 

* ©pgr: forward name =" get Name" 
* 

path=" /employeelnf oWizard/Employeelnf oWizard . pgr" 
*/ 

public Forward begin ( ) 

{ 

Employeelnf oWizard . Employeelnf oForm form = 

Employeelnf oWizard . Employeelnf oForm ( ) ; 
form. setFirstName (firstName) ; 
form. setLastName (lastName) ; 

return new Forward ( "getName" , form); 

} 

I * * 

* ©pgr: action 

* ©pgr: forward name="get JobDesc" 
path=" j obDescription . j sp" 

*/ 

public Forward 

employeelnf o_done (Employeelnf oWizard . Employeelnf oForm 
form) 

{ 

firstName = f orm . getFirstName ( ) ; 
lastName = form . getLastName ( ) ; 

JobDescriptionForm jobDescForm = new 
JobDescriptionForm ( ) ; 

return new Forward ( "get JobDesc" , jobDescForm); 

} 

I * * 

* ©pgr: action 

* ©pgr: forward name="getName" 
* 

path=" /employee InfoWizard/Employeelnf oWizard .pgr" 
*/ 

public Forward j obDescPage_previous (JobDescriptionForm 
form) 

{ 

title = form. getTi tie () ; 
startDate = f orm . getStartDate ( ) ; 

Employeelnf oWizard . Employeelnf oForm form = 
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Employeelnf oWizard . Employee InfoForm ( ) ; 
form. setFirstName (f irstName) ; 
form. setLastName (lastName) ; 

return new Forward ( "getName" , form); 

} 

/ * ★ 

* ©pgr: action 

* ©pgr : forward name = " ge t Conf i rm" path=" confirmation . j sp" 
*/ 

public Forward jobDescPage_next ( JobDescriptionForm form) 

title = f orm . getTitle ( ) ; 
startDate = form. get StartDate () ; 

HireForm hireForm = new HireFormO; 
hireForm . setFirstName ( f irstName) ; 
hireForm. setLastName (lastName) ; 
hireForm. setTitle (title) ; 
hireForm. setStartDate (startDate) ; 

return new Forward ( "getConfirm" , hireForm); 

} 

/ * * 

* ©pgr: action 

* ©pgr: forward name="readyForNextCandidate" 

path=" / employeelnf oWizard/Employeelnf oWizard . pgr" 

* ©pgr: catch type=" com . acme . Workf lowExcept ion" 
method=" onError" 

*/ 

public Forward conf irmationPage_hire (HireForm form) 
throws Exception 

{ 

hiringService . hire (f irstName, lastName, title, 
startDate) ; 

f irstName = null; 
lastName = null; 
title = null; 
startDate = null; 

Employeelnf oWizard. Employeelnf oForm form = 

Employeelnf oWizard . Employeelnf oForm ( ) ; 
form. setFirstName (f irstName) ; 
form. setLastName (lastName) ; 

return new Forward ( "readyForNextCandidate" , form); 

} 

I ★ * 

* ©pgr: action 

* ©pgr: forward name= / 'getHelp" path=" /help/Help . pgr" 
*/ 

public Forward j obDescriptionPage help ( ) 

{ 

Help . HelpContextForm helpForm = new 
Help . HelpContextForm ( ) ; 

helpForm. setHelpContextld (Help . HelpContextForm . HIRING 
WIZARD) ; 
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return new Forward ( "getHelp" , helpForm) ; 



J * * 

* ©pgr: action 

* ©pgr: forward name=" returnToPage" returnTo="page" 
*/ 

public Forward help done ( ) 

{ 

return new Forward ( "returnToPage" ) ; 

} 

I * * 

* ©pgr : exceptionHandler 

* ©pgr: forward name =" error" path= " error . j sp" 
*/ 

protected Forward onError (Exception e, 

String errorMethodName, 
String messageKey, 
String message, 
Form form) 



{ 



} 

} 



// TODO: Add some code to handle error 
return new Forward ( "error" ) ; 



[0106] By way of a non-limiting example of the scenario in which a page 

group can support interruption of a web flow to ensure that important preconditions 
are met before continuing the web flow. In this example, the HiringWizard 
page group's conf irmationPage_hire action method has a precondition that 
can be satisfied before the hiring workflow may be initiated. The precondition is 
that the web site user can be logged in before initiating a hiring workflow. 
[0107] To accomplish logins, the humanResources web application can 

containa loginpage group. The conf irmationPage_hire action method 
can test to see if the web site user is logged in. If the user is not logged in, then the 
confirmationPage_hire method nests the Login page group to login the 
user: 

package hiringWizard; 
import j ava . util . Date ; 

import com . bea . wlw . netui . pagegroup . PageGroup ; 
import com . bea . wlw . netui . pagegroup . Forward ; 
import com . bea . wlw . netui . pagegroup . Form ; 

import hiringService . HiringService ; 
import help. Help; 

import employeelnf oWizard . Employeelnf oWizard; 
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import com. acme . User ; 

public class HiringWizard extends PageGroup 

{ 

protected String firstName; 
protected String lastName; 
protected String title; 
protected Date startDate; 

I * * 

* @wlw: control 
*/ 

HiringService hiringService; 

User user; 
I * * 

* ©pgr: begin 

* ©pgr: forward name =" get Name" 
★ 

path=" /employeelnf oWizard/Employeelnf oWizard .pgr" 

*/ 

public Forward begin ( ) 

{ 

Employeelnf oWizard . Employeelnf oForm form = 

Employeelnf oWizard . Employeelnf oForm ( ) ; 
form. setFirstName ( firstName) ; 
form. setLastName (lastName) ; 

return new Forward ( "getName" , form); 

} 

I * * 

* ©pgr: action 

* ©pgr: forward name="get JobDesc" 
path=" jobDescription . j sp" 

*/ 

public Forward 

employeelnf o_done (Employeelnf oWizard . Employeelnf oForm 
form) 

{ 

firstName = f orm . getFirstName ( ) ; 
lastName = form . getLastName ( ) ; 

JobDescriptionForm jobDescForm = new 
JobDescriptionForm ( ) ; 

return new Forward ( "get JobDesc" , jobDescForm); 

} 

I * * 

* ©pgr: action 

* ©pgr: forward name="getName" 
* 

path=" /employeelnf oWizard/Employeelnf oWizard . pgr" 
*/ 

public Forward j obDescPage_previous (JobDescriptionForm 
form) 

{ 

title = f orm. getTitle ( ) ; 
startDate = f orm. getStartDate ( ) ; 

Employeelnf oWizard . Employeelnf oForm form = 
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Employeelnf oWizard . Employee InfoForm ( ) ; 
form. setFirstName (f irstName) ; 
form. setLastName (lastName) ; 

return new Forward ( "getName" , form); 

} 

I * * 

* ©pgr: action 

* ©pgr : forward name=" get Confirm" path="conf irmation . j sp 
*/ 

public Forward j obDescPage^next ( JobDescriptionForm form) 

{ 

title = form.getTitle () ; 
startDate = f orm . getStartDate ( ) ; s 

HireForm hireForm = new HireForm (),- 
hireForm. setFirstName (f irstName) ,- 
hireForm . setLastName ( lastName) ; 
hireForm . setTitle (title) ; 
hireForm . setStartDate (startDate) ; 



} 



return new Forward ( "getConfirm" , hireForm) ; 



j * * 

* ©pgr: action 

* ©pgr : forward name=" readyForNextCandidate" 
* 

path=" /employeelnf oWizard/Employeelnf oWizard .pgr" 

* ©pgr: forward name="getLogin" path=" /login/Login . pgr" 

* ©pgr: catch type=" com . acme . Workf lowException" 
method="onError" 

*/ 

public Forward conf irmationPage_hire (HireForm form) 
throws Exception 

{ 

if (user == null) 

{ 

return new Forward ( "getLogin" ) ; 

} 

hiringService .hire (f irstName, lastName, title, 
startDate) ; 

f irstName = null; 
lastName = null; 
title = null ; 
startDate = null; 

Employeelnf oWizard . Employeelnf oForm form = 

Employeelnf oWizard . Employeelnf oForm ( ) ; 
form. setFirstName (f irstName) ; 
form. setLastName (lastName) ; 



} 



return new Forward ( "readyForNextCandidate" , form) ; 



j * * 

* ©pgr: action 

* ©pgr: forward name="getHelp" path=" /help/Help . pgr" 
*/ 

public Forward j obDescriptionPage_help ( ) 
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Help . HelpContextForm helpForm = new 
Help . HelpContextForm ( ) ; 

helpForm. setHelpContextld (Help . HelpContextForm . HIRING 
WIZARD) ; 

return new Forward ( "getHelp" , helpForm); 



* * 



* ©pgr: action 

* ©pgr: forward name="returnToPage" returnTo="page" 
*/ 

public Forward help_done() 

{ 

return new Forward ( w re turnToPage" ) ; 

} 

I * * 

* ©pgr : excep t i onHandl e r 

* ©pgr: forward name=" error" path= " error . j sp" 
*/ 

protected Forward onError (Exception e, 

String errorMethodName, 
String messageKey, 
String message, 
Form form) 

{ 

// TODO : Add some code to handle error 



return new Forward ( "error" ) ; 

} 

} 

[0108] The Login page group is a simple page group that returns a 

UserForm that contains a User object that corresponds to the user that logged in: 

package login; 

import com . bea . wlw . ne tui . pagegroup . PageGroup ; 
import com . bea . wlw . ne tui . pagegroup . Forward ; 
import com . bea . wlw. netui . pagegroup . Form; 

import com. acme .User ; 

import loginService . LoginService ; 

/ * * 

* pgr: nestable 
*/ 

public class Login extends PageGroup 

{ 

I * * 

* ©wlw: control 
*/ 

protected LoginService loginService; 
I * * 

* ©pgr: begin 

* ©pgr: forward name="getLogin" path=" login . j sp" 
*/ 
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public Forward begin () 
{ 

return new Forward ( "getLogin" ) ; 

} 

I * * 

* ©pgr: action 

* ©pgr : forward name =" success" 

* returnAction=" login_done" 

* re turnFormType=" User Form" 

* ©pgr: forward name=" failure" path=" failure . j sp" 
*/ 

public Forward loginPage login (LoginForm form) 

{ 

User user = loginService . login (form. getUserName () , 

f orm.getPassword ( ) ) ; 

if (user ! = null) 

{ • 

UserForm userForm = new UserFormO; 
userForm. setUser (user) ; 

return new Forward ( "success" , userForm); 

} 

else 

{ 

return new Forward ( "failure" ) / 

} 

} 

public static class LoginForm extends Form 

{ 

protected String userName; 
protected String password; 

public String getUserName ( ) 

{ 

return userName; 

} 

public void setUserName (String userName) 

{ 

this . userName = userName; 

} 

public String getPassword ( ) 

{ 

return password; 

} 

public void setPassword (String password) 
this . password = password; 

} 

} 

public static class UserForm extends Form 

{ 

protected User user; 
public User getUser () 

{ 

return user; 

} 
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public void setUser (User user) 
{ 

this. user = user; 

} 

} 

} 

[0109] Upon return to the HiringWi zard page group from the Login 

page group, the system executes the login_done action method. The login_done 
method sets the user field, and then causes a forward back to the 
conf i rma t i onPage_hi re action method: 

/ * * 

* ©pgr: action 

* ©pgr: forward name ="retumToAct ion" returnTo=" action" 
*/ 

public Forward login done (UserForm form) 

{ 

user = form.getUser () ; 

return new Forward ( "returnToAct ion" ) / 

} 

} 

[0110] The confirmationPagehire action method is then re-executed. 

During the second execution, the confirmationPage hire method will detect that 
the user field has been set, and will continue on to initiate the hiring workflow. 
[0111] In one embodiment, a global page group is a place to put user 

interface control code that can be reachable by all pages and page groups of a web 
site. By way of a non-limiting example, the global page group is a place to put a 
web site search action method that is used by a page template that gets included by 
all of the pages of a web site. Like a regular page group, the global page group is 
defined in a specially-named file. The file is named global . application, 
and there can be one such file per web application. Like regular page groups, the 
global page group is defined as an annotated Java class. By way of a non-limiting 
example, the human resource application's global page group may defined as: 

import com.bea . wlw.netui .pagegroup . Controller; 
public class GlobalApp extends Controller 

{ 

* • • 

} 
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[0112] Global page groups can contain lifecycle methods. Global page 

groups inherit empty implementations of the lifecycle methods from 
Controller, and may override the implementations to suit the needs of the 
application. The lifecycle methods are called by the system and provide important 
notifications of application status. By way of a non-limiting example, the 
Controller class contains empty implementations of onAppInit and 
onAppDestroy, and the GlobalApp class may override these methods as 
follows: 



import com. bea . wlw. netui . pagegroup . Controller ; 
public class GlobalApp extends Controller 

{ 

public onAppInitO 

{ 

• • • 

} 

pub lie onAppDe s t roy ( ) 

{ 

■ m * 

} 

} 

[0113] In one embodiment, the global page group class may contain action 

methods and annotations may also be used. By way of a non-limiting example, 
GlobalApp may contain a search action method: 



import com . bea . wlw. netui . pagegroup . Controller; 
import com . bea . wlw. netui . pagegroup . Forward; 
import com . bea . wlw . netui . pagegroup . Form; 

import com . acme . SearchService ; 
import com . acme . SearchResults ; 

public class GlobalApp extends Controller 

{ 

I * * 

* @wlw : control 
*/ 

protected SearchService service ; 
public onAppInitO 

{ 

• • • 

} 

public onAppDestroy ( ) 
{ 
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} 
/ 



* ©pgr: action 

* ©pgr : forward name=" showSearchResults" 
path=" /searchResults . j sp" 

*/ 

public Forward search (SearchForm form) 

{ 

SearchResults results = 

searchService . search ( form . getQuery ( ) ) ; 

SearchResultsForm resultsForm = new 
SearchResultsForm ( ) ; 

resultsForm. setSearchResults (results) / 



} 



return new Forward ( "showSearchResults" ) ; 



public static class SearchForm extends Form 

{ 

protected String query; 
public String getQuery () 

{ 

return query; 

} 

public void setQuery (String query) 

{ 

this. query = query; 

} 

} 

public static class SearchResultForm extends Form 

{ 

protected SearchResults searchResults; 
public SearchResults getSearchResults ( ) 

{ 

return searchResults; 

} 

public void setSearchResults (SearchResults ' 
searchResults ) 



{ 
} 



this . searchResults = searchResults; 



} 

[0114] 



} 



public String getResult (int index) 

{ 

» * * 

} 



Note that the path provided for the showSearchResults 



forward begins with a slash. This is because web application relative addressing 
can be used in the global page group since the global page group is not associated 



with any pages. 
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[0115] In one embodiment, when a page in a page group requests that an 

action be performed, the system looks for the action method in the page's page 
group controller class. If the system is unable to find an action method for the 
action within the page's page group controller class, then the system searches the 
global page group controller class for an action method. By way of a non-limiting 
example, the name . j sp page of the hiringWizard page group could have a 
search form. 

[0116] When a user presses the Search button the system looks for the 

action method to service the search request. Because the HiringWizard page 
group does not contain a search action method, the system will look in the 
GlobalApp page group to find a search method. Upon finding the search 
method in the GlobalApp page group, the system will execute that method. 
[0117] The search method in the GlobalApp page group returns a 

Forward object that refers to a searchResults . j sp page. The 
searchRe suits . j sp page is file that is located in the web application root 
directory. It can contain a Done button which, when selected by a user, causes a 
searchPage_done action method to be sent to the controller. In response, the 
controller looks for a searchPage__done action method in the 
HiringWi zard page group. Because the Hi ringWi zard page group does not 
contain a searchPage_done action method, the system looks for a 
searchPage_done action method in the GlobalApp page group. The 
GlobalApp page group contains such a method and it looks like: 

import com . bea . wlw . netui . pagegroup . Controller; 
import com . bea . wlw . netui . pagegroup . Forward ; 
import com . bea . wlw . netui . pagegroup . Form; 

import com . acme . SearchService ; 
import com. acme . SearchResults ; 

public class GlobalApp extends Controller 

{ 

I * * 

* ©wlw: control 
*/ 

protected SearchService service; 
public onAppInitO 

{ 

• ♦ * 
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} 

public onAppDestroy ( ) 

{ 

» • • 

} 

I * * 

* ©pgr: action 

* ©pgr : forward name=" showSearchResults" 
path=" /searchResults . j sp" 

*/ 

public Forward search (SearchForm form) 

{ 

SearchResults results = 

searchService . search ( form . getQuery ( ) ) ,- 

SearchResults Form result sForm = new 
SearchResultsForm ( ) ; 

resultsForm. setSearchResults (results) ; 



} 
/ 



return new Forward ( "showSearchResults" ) ; 



* * 

* ©pgr taction 

* ©pgr : forward name = " r e t ur nToPage " returnTo="page" 
*/ 

public Forward searchPage_done ( ) 

{ 

return new Forward ( "ret urnToPage" ) ; 

} 

public static class SearchForm extends Form 

{ 

protected String query; 
public String getQuery () 

{ 

return query; 

} 

public void setQuery (String query) 

{ 

this. query = query; 

} 

} 

public static class SearchResultForm extends Form 

{ 

protected SearchResults searchResults; 
public SearchResults getSearchResults ( ) 

{ 

return searchResults; 

} 

public void setSearchResults (SearchResults 
searchResults ) 

{ 

this . searchResults = searchResults; 

} 
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public String getResult (int index) 
{ 

• « ■ 

} 

} 

} 

[0118] In this example, the searchPage_done action method returns a 

Forward object that encapsulates a returnTo="page" attribute. Because of this 
attribute the system will return the user to the Hiring Wizard page group's name jsp 
page that the user was viewing when the user originally requested the search. 
[01 19] In on embodiment, the System provides several classes that may be 

used by page group developers: 



CLASS 


DESCRIPTION 


PageGroup 


The base class for all page group controller classes 


Forward 


Encapsulates URLs 


Form 


The base class for all forms 



Table 1 : Exemplary Classes in an Embodiment 



[0120] The system provides several annotations that may be used by page 

group developers. The annotations can include the following: 



NAME 


WHERE USED 


DESCRIPTION 


@pgr: action 


Action methods 


Designates an action method. 


@pgr: forward 


Action methods 
Page group class 


Provides the information that will 
be encapsulated by a Forward 
object. 


@pgr:catch 


Action methods 
Page group class 


Provides the information to be used 
by the system to catch exceptions 
and possibly route them to error 
handlers. 


@pgr:exceptionHandler 


Error handler 
methods 


Designates an error handler method. 


@pgr:nestable 


Page group class 


Designates a nestable page group. 


@wlw: control 


Instance members 


Indicates that an instance member 
references a Workshop control. 


@pgr:validation 


Page group class 


Describes form validation checks to 
be performed by the system. 
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Table 2: Exemplary Annotations in an Embodiment 



[0121] The ©pgr : forward annotation can be used to describe a location 

to which the system should forward. The location may be a page, a page group or 
an action method. The forward annotation is usually applied to action methods, but 
may also be applied to a page group class. When applied to an action method, the 
forward annotation describes a local forward. When applied to a page group class, 
the forward annotation describes a global forward. Although local and global 
forwards work the same way, they are given different representations within the 
various views of the IDE. The forward annotation has the following attributes: 



NAME 


REQUIRED 


VALUES 


DESCRIPTION 


name 


Yes 


Any string 


The logical name of a forward. 


path 


Either this 
attribute, the 
returnAction 
attribute or 
the returnTo 
attribute can 
be specified. 


A string which 
maps to either a 
page or page 
group in a web 
application, an 
action method 
within a page 
group or to a 
resource 

somewhere on the 
web 


The path to a resource to which 
the system should forward. The 
path may be to a resource in the 
web application or to a resource 
outside of the web application. If 
the path begins with a protocol 
such as "http:", then the system 
will look outside of the web 
application for the resource. If the 
path begins with a "/" then the 
system will use web application 
root relative addressing to locate 
the resource. If the path does not 
begin with a protocol or a "/" 
then the system will use page 
group relative addressing to 
locate the resource. If the path 
does not begin with a protocol or 
a "/" then the system will use 
page group relative addressing to 
locate the resource. 


returnAction 


Either this 
attribute, the 
path attribute 
or the 
returnTo 
attribute can 
be specified. 


The name of an 
action to invoke 
upon return to a 
nesting page 
group 


This specifies the name of an 
action in the nesting page group 
that should be invoked upon 
return to the nesting page group. 
In the case where multiple actions 
with names equal to that of 
returnAction exist, either 
returnFormType or the type of the 
variable specified by returnForm 
will be used to disambiguate and 
select the correct action in the 
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nesting page group. 


returnForm 
Type 


No. May not 
be specified 
returnrorm is 
specified. 


The name of a 
Form type 


This specifies the type of the 
Form object that will be returned 
uy ine action 10 me nesting page 
group. If this attribute is not 
specified, then the type of the 
Form object returned by the 
action method will be determined 
by examining the type of the 
instance member identified by 
returnForm. 


returnForm 


No. May not 
De speciiieci 
returnForm is 
specified. 


The name of a 
page group 
instance member 


The name of a page group 
instance memoer to use as tne 
form data upon return to a nesting 
page group. Use of the instance 

inci nuci aiou rncaiib use ux tne 
instance member's type to help 
determine which action method to 
select upon return to the nesting 
page group. 


redirect 


No. May only 
be used when 
path is used. 


true or false, false 
is the default 
value. 


When true, navigation is 
performed using the Servlet 
redirect method. 


returnTo 


Either this 

attribute can 

dill l l_/ U L VClll 

be set, the 
path attribute 
can be set or 
the 

returnAction 
attribute can 
be set. 


page or action. 


When set to page, the system 
automaticallv forwards to the last 
page used by the page group. 
This is useful for return to page 
nesting scenarios. When set to 
action, the system automatically 
forwards to the action that 
preceded the call of this action. 
This is useful for preconditions. 



Table 3: Exemplary @pgr : forward Annotation Attributes in an 

Embodiment 



[0122] The @prg : catch annotation describes an exception catch that the 

system should perform. The @prg : catch annotation has the following 
attributes: 



NAME 


REQUIRED 


VALUES 


DESCRIPTION 


type 


Yes 


Any fully-qualified Java 
exception type 


This specifies the Java type of 
the exceptions that should be 
caught 


path 


Either this 


A string which maps to 


This specifies the resource to 
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attribute or 
method 
attribute can 
be specified 


either a page or page 
group in a web 
application, and action 
method within a page 
group or to a resource 
somewhere on the web 


which the system should 
forward when it catches an 
exception of type. 


method 


Either this 
attribute or 

_ 4.1— 

patn 

attribute can 
be specified 


The name of an 
exception handler 
metnoo wnicn is 
designated with a 
@pgr:exceptionHandler 
annotation 


This specifies the name of an 
exception handler method that 
snouia oe caneo n an 
exception of type is caught. 


message 


No 


Any string which 

rvrovidps useful 

information about the 
exception 


This is an error message that 
mav be used to orovide helnful 
information about the 
exception. 


message 
Key 


No 


A key that may be used 
to select a message from 
a message map. 


This is a key that is used to 
select a message from a map. 
Typically this key is used to 
enable internationalization of 
messages. 



Table 4: Exemplary @prg : catch Annotation Attributes in an Embodiment 



[0123] The @prg : val idat ion annotation describes a form validation 

check to be performed by the system. The validation annotation has the following 
attributes: 



NAME 


REQUIRED 


VALUES 


DESCRIPTION 


property 


Yes 


Name of property in 
Form class 


The name of a property in the 
form class 


required 


No 


true or false 


If true, then the associated 
property can be set. 


pattern 


No 


An expression that 
describes allowable 
settings of the 
property 


An expression that describes 
allowable settings of the 
property 



Table 5: Exemplary @prg : val idat ion Annotation Attributes in an 

Embodiment 



[0124] One embodiment may be implemented using a conventional general 

purpose or a specialized digital computer or microprocessor(s) programmed 
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according to the teachings of the present disclosure, as will be apparent to those 
skilled in the computer art. Appropriate software coding can readily be prepared by 
skilled programmers based on the teachings of the present disclosure, as will be 
apparent to those skilled in the software art. The invention may also be 
implemented by the preparation of integrated circuits or by interconnecting an 
appropriate network of conventional component circuits, as will be readily apparent 
to those skilled in the art. 

[0125] One embodiment includes a computer program product which is a 

storage medium (media) having instructions stored thereon/in which can be used to 
program a computer to perform any of the features presented herein. The storage 
medium can include, but is not limited to, any type of disk including floppy disks, 
optical discs, DVD, CD-ROMs, microdrive, and magneto-optical disks, ROMs, 
RAMs, EPROMs, EEPROMs, DRAMs, VRAMs, flash memory devices, magnetic 
or optical cards, nanosystems (including molecular memory ICs), or any type of 
media or device suitable for storing instructions and/or data. 
[0126] Stored on any one of the computer readable medium (media), the 

present invention includes software for controlling both the hardware of the general 
purpose/specialized computer or microprocessor, and for enabling the computer or 
microprocessor to interact with a human user or other mechanism utilizing the 
results of the present invention. Such software may include, but is not limited to, 
device drivers, operating systems, execution environments/containers, and user 
applications. 

[0127] The foregoing description of the preferred embodiments of the 

present invention has been provided for the purposes of illustration and description. 
It is not intended to be exhaustive or to limit the invention to the precise forms 
disclosed. Many modifications and variations will be apparent to the practitioner 
skilled in the art. Embodiments were chosen and described in order to best 
describe the principles of the invention and its practical application, thereby 
enabling others skilled in the art to understand the invention, the various 
embodiments and with various modifications that are suited to the particular use 
contemplated. It is intended that the scope of the invention be defined by the 

Attorney Docket No.: BEAS-01402US1 SRM/DJB Express Mail Label No.: EV3276221 88US 

djb/beas/1402USl application.doc 



60 

following claims and their equivalents. 
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